home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d13 / nm091.arc / NM.DOC < prev    next >
Text File  |  1991-05-29  |  14KB  |  350 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.                                Now Menu 0.90
  22.  
  23.                           by Bradford B. Taliaferro
  24.  
  25.                                 SempriniWare
  26.  
  27.               SoftWare that doesn't listen to wicky-wicky tunes
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36. INTRODUCTION:  Now Menu is the menu system that lets you add menuing to any
  37.                player/viewer program.  The program is generalized and will 
  38.                work with ANY DOS command.  Thus you may use it to menu any
  39.                sound player, menu any picture viewer or any other program.
  40.  
  41.  
  42. DESCRIPTION:  Now Menu creates a batch file with a menu chosen file for
  43.               some user defined operation.  Using NM, a simple menu system
  44.               can be created in seconds for any DOS program.  No more searching
  45.               through directory listings to find the one file you wish to use.
  46.  
  47. USAGE:         NM /Bbatfile /Ffilespec /Ccommand [/1parm1.../1parmx]
  48.                          [/2parm1.../2parmx]  [/Ttitle] [/@configfile]
  49.                          [/A1color]...[/A6color]
  50.  
  51.                Specify each option you wish (/C is necessary) in any order.
  52.                Do not put a space between the switch and the accompanying
  53.                specification (i.e. /BTEMP.BAT not /B TEMP.BAT).
  54.  
  55.                /Bbatfile is the batch file name to be created.
  56.  
  57.                /Ffilespec is the path/file specification  for the program to 
  58.                use when it runs.  For example, if you are menuing a
  59.                VOC player use *.VOC or C:\SB\VOXKIT\*.VOC.
  60.  
  61.                /Ccommand is the program to be run.  Sticking with our VOC
  62.                example we could put VPLAY here, or C:\SB\VOXKIT\VPLAY.
  63.  
  64.                /1parm1.../1parmx   or  /2parm1.../2parmx are the optional
  65.                parameters for the program.  With our example we might use
  66.                /Q.  Note that /1 parameters are included BEFORE the file 
  67.                specification and /2 parameters are included AFTER the file
  68.                specification.  (See example below for more details.)
  69.  
  70.                /Ttitle is a menu title to display at the top of the screen when
  71.                making menu selections.  Instead of spaces in your title use the
  72.                underbar "_" character.  It will be replaced by spaces when the
  73.                program prints your title.
  74.  
  75.                /@configfile is a file name of a configuration file containing
  76.                any of the command line parameters excluding the /@.  Using /@
  77.                by itself with no config file name will disable the reading of
  78.                the config file.  If you do not include a file extension an
  79.                extension of .NM will be added.  For a file with no extension
  80.                use the filename with a dot after it i.e., /@CONFIG.
  81.  
  82.  
  83.  
  84.                /A1color.../A6color set the color attributes for different parts
  85.                of the menu.  The format is /AXyy where X is one of the
  86.                following numbers:
  87.  
  88.                        1 - The foreground color of the menu choices
  89.                        2 - The background color of the menu choices
  90.                        3 - The foreground color of the highlight bar
  91.                        4 - The background color of the highlight bar
  92.                        5 - The foreground color of the menu title
  93.                        6 - The background color of the menu title
  94.  
  95.                and yy is one of the following colors numbers:
  96.  
  97.                         0 - black      --------
  98.                         1 - blue                \
  99.                         2 - green                 \
  100.                         3 - cyan                    \ Background colors can
  101.                         4 - red                     / only be 0 thru 7
  102.                         5 - magenta               /
  103.                         6 - brown               /
  104.                         7 - light gray --------
  105.                         8 - dark gray
  106.                         9 - light blue
  107.                        10 - light green        (Add 128 to make colors blink)
  108.                        11 - light cyan
  109.                        12 - light red
  110.                        13 - light magenta
  111.                        14 - yellow
  112.                        15 - white
  113.  
  114.                Thus, to make the title appear in yellow on blue, specify the
  115.                following parameters on the command line or in the CONFIG file.
  116.  
  117.                     /A514 /A61
  118.  
  119.                The colors default to black and white so monochrome displays
  120.                will not be left out.
  121.  
  122.                (Note that NM /VER will display the name and version number of
  123.                 the program.  This is a SempriniWare standard feature.  Also
  124.                 standard is help display with the 
  125.                 parameters /, ?, /?, /h, or /H).
  126.  
  127.  
  128. KEYS:          Keys active while the menu is being display are as follows:
  129.  
  130.  
  131.                A - Sort list in ascending alphanumeric order.
  132.  
  133.                D - Sort list in descending alphanumeric order.
  134.  
  135.                PgUp - Display next page of names (when more than 120 files are
  136.                       available.
  137.  
  138.                PgDn - Display previous page of name (when more than 120 files
  139.                       are available.
  140.  
  141.                ESC - (escape key) Aborts the program.  No batch file is
  142.                      created.
  143.  
  144.                RETURN - (return or enter key) Exits the program, selecting the
  145.                         highlited file.  A batch file is created using the
  146.                         specified command and the selected file.
  147.  
  148.                CURSOR or ARROW keys - move the highlite bar around to select
  149.                                       the file name to be used.
  150.  
  151.                HOME - Go to beginning of screen
  152.  
  153.                END - Go to end of screen
  154.  
  155.  
  156.  
  157.  
  158.  
  159. NOTES:         Any and all parameters (except the /@) may be put into a config
  160.                file.  A suggested use is to put a CONFIG.NM into each directory
  161.                where NM will be used.  Thus you may have a specialized config
  162.                file for each application.  The structure of the config file is
  163.                the same as the command line parameters, with one parameter on
  164.                each line of the file:
  165.  
  166.                     /Cdir
  167.                     /F*.*
  168.                     /TSilly_directory_menu
  169.                     /B$$$TEMP.BAT
  170.                     
  171.                The config file default name is CONFIG.NM.  If no parameters are
  172.                specified the program will look for CONFIG.NM in the current
  173.                directory.  If it is not found, the program will terminate.
  174.  
  175.                When the program processes command line parameters, it first
  176.                looks for a config file.  If one is specified it will look for
  177.                that one, otherwise it will look for CONFIG.NM.  Once it reads
  178.                in from any config file it finds, the program then processes
  179.                the command line parameters.  Thus, any parameters specified
  180.                on the command line will overwrite those in the config file.
  181.                For example:
  182.  
  183.                      NM /F*.PAS /CTYPE /TLook_at_Pascal_progs
  184.  
  185.                is our command line.  Our config file contains the line:
  186.  
  187.                      /TThese_are_Pascal_progs
  188.  
  189.                The title that will be displayed is:
  190.  
  191.                       Look at Pascal progs
  192.  
  193.  
  194. EXAMPLE:       For this example lets use the VPLAY command for Sound Blaster
  195.                voice files.  We have a pile of VOC files and no menu, right?
  196.                Well, here is a very simple solution:
  197.  
  198.                Assume the following:
  199.  
  200.                   1.  Our VPLAY program is in C:\SB\VOX
  201.                   2.  Our .VOC files are in C:\SB\VOICE
  202.                   3.  Our NM program is in C:\UTILS
  203.                   4.  We want a parameter before and after the file spec.
  204.  
  205.  
  206.                A useful implementation of NM would be in the following batch
  207.                file:
  208.  
  209.         @ECHO OFF
  210.         :TOP
  211.         C:\UTILS\NM /B$$TEMP$$ /FC:\SB\VOICE\*.VOC /CC:\SB\VOX\VPLAY /1/Q /2/T9
  212.         IF EXISTS $$TEMP$$.BAT GOTO RUN
  213.         GOTO EXIT
  214.         :RUN
  215.         CALL $$TEMP$$
  216.         ERASE $$TEMP$$.BAT
  217.         CLS
  218.         GOTO TOP
  219.         :EXIT
  220.         CLS
  221.  
  222.                This would run the program, call the created batch file, then
  223.                erase it from the disk, then return to the menu for another
  224.                selection.  Pressing ESC from the menu program will cause the
  225.                batch file to be erased and exits the menu.  When the batch 
  226.                file sees the $$TEMP$$.BAT doesn't exist - it ends.  Thus we 
  227.                have a simple menu program!  The advantage of this program is
  228.                that works in batch mode instead of calling the program itself.
  229.                This allows the program to be used in conjunction with real 
  230.                memory hogs.  It also allows the creation of batch files that
  231.                call many different systems, each with a simple menu!
  232.  
  233.                Lets say we picked a file called SHOUT.VOC from the menu.  Our
  234.                sample batch file, $$TEMP$$.BAT would look like this:
  235.  
  236.                   C:\SB\VOX\VPLAY /T9 C:\SB\VOICE\SHOUT.VOC /Q
  237.  
  238.                Normally, we wouldn't want the /T9 parameter before the file
  239.                name, but we did it here for an example only.
  240.  
  241.                We could also make the .VOC menu with a config file.  The
  242.                following config file should be in the directory with the
  243.                *.VOC files (named CONFIG.NM):
  244.  
  245.                    /B$$TEMP$$
  246.                    /FC:\SB\VOICE\*.VOC
  247.                    /CC:\SB\VOX\VPLAY
  248.                    /1/Q
  249.                    /2/T9
  250.  
  251.  
  252.                Then our batch file would look like this (call it M.BAT):
  253.  
  254.                      @ECHO OFF
  255.                      :TOP
  256.                      C:\UTILS\NM
  257.                      IF EXISTS $$TEMP$$.BAT GOTO RUN
  258.                      GOTO EXIT
  259.                      :RUN
  260.                      CALL $$TEMP$$
  261.                      ERASE $$TEMP$$.BAT
  262.                      CLS
  263.                      GOTO TOP
  264.                      :EXIT
  265.                      CLS
  266.  
  267.                We could also create a CONFIG.NM in our \SB\TRAKBLAS directory
  268.                which contains the .MOD files for Trak Blaster.  That config
  269.                file would look like this:
  270.  
  271.                    /B$$TEMP$$
  272.                    /FC:\SB\TRAKBLAS\*.MOD
  273.                    /CC:\SB\TRAKBLAS\VPLAY
  274.                    /TTrak_Blaster_Songs
  275.  
  276.                With M.BAT residing in a directory in the DOS path, it is a
  277.                simple task to create CONFIG.NM files for any application that
  278.                requires menuing.
  279.  
  280.                see EXAMPLE.BAT for another, working example of the programs
  281.                unlimited usage.
  282.  
  283.  
  284.  
  285.  
  286. REGISTRATION:  Registration is requested at $15.00 US funds.  Registered users
  287.                will recieve one free update along with a disk of my other
  288.                shareware programs.  Registered users are also entitled to help
  289.                via the Micron Firefly BBS including the setup of special batch
  290.                files for your applications.  See below for our phone number.
  291.  
  292. UPDATES: 
  293.  
  294.                0.90 - initial release.  No bugs, of course (hee hee hee).  I am
  295.                taking advantage of Mike Durkin's fine CRC check program and his
  296.                generous Shareware allowances.  If I make any - you'll get yours
  297.                Mike!
  298.  
  299.                0.91 - Added colors, config file, more intuitive key activity,
  300.                and fixed a bug in the screen after moving from one page to
  301.                another.  Special thanks to John Trindle for testing and
  302.                suggestions for improvements.
  303.  
  304.  
  305.  
  306.  
  307.                REGISTRATION FORM - NM 0.90 - FEE [$15]
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315. NAME ___________________________     PHONE (Optional)__________________
  316.  
  317. ADDRESS_________________________     CITY, STATE_______________________
  318.  
  319. ZIP_____________________________     OCCUPATION________________________
  320.  
  321. COMPUTER USE (programs, games, etc, i.e. 'what do you do?')____________
  322. _______________________________________________________________________
  323. _______________________________________________________________________
  324. _______________________________________________________________________
  325.                                                                        
  326. COMMENTS_______________________________________________________________
  327. _______________________________________________________________________
  328. _______________________________________________________________________
  329. _______________________________________________________________________
  330. _______________________________________________________________________
  331. _______________________________________________________________________
  332. _______________________________________________________________________
  333. _______________________________________________________________________
  334. _______________________________________________________________________
  335. _______________________________________________________________________
  336.  
  337.  
  338.      Contributions are encouraged and suggestions are invited.  Send all 
  339. correspondence to:
  340.  
  341.                         Bradford B. Taliaferro
  342.                         609 North 3rd Street
  343.                         Savannah, MO 64485
  344.  
  345.  
  346. Also, call the Micron Firefly BBS - Home of SempriniWare.  We are moving to our
  347. new phone location on June 5th.  Call us at 816-324-3148 after June 5th or at
  348. 717-724-4280 until June 3rd.
  349.  
  350.